home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / rquest01.zip / REQUEST.DOC < prev    next >
Text File  |  1992-03-16  |  5KB  |  106 lines
  1. '+--------------------------[ Request  Ver 0.10 ]----------------------------+
  2. '|  Written By Gary Meeker 03/16/92                        Updated   /  /    |
  3. '|  SYSOP: SHARP Technical Support Line BBS               Lawrenceville, GA  |
  4. '|         (404) 962-1788                 300/1200/2400/9600 Baud. 24 Hours  |
  5. '+---------------------------------------------------------------------------+
  6. 'V0.10 03/16/92 - Initial release (Beta)
  7. '-----------------------------------------------------------------------------
  8.  
  9. Syntax:
  10.  
  11. REQUEST PCBDir ConfigFile
  12.  
  13. Where:  PCBDir     = Drive:Path to the PCBoard Directory (for PCBOARD.SYS)
  14.         ConfigFile = Drive:Path to our configuration file.
  15.  
  16. The Configuration file contains the following information:
  17.   Line  1: Drive:Path\Filename of USERS File.
  18.   Line  2: Drive:Path\Filename of the DataBase INDEX file to be read
  19.   Line  3: Drive:Path\Filename of the DataBase INDEX file to be created
  20.   Line  4: Starting position of value in Sysop Comment Field.
  21.   Line  5: Text to send when no files are available.
  22.   Line  6: Text to send when limit reached.
  23.   Line  7: Maximum number of files that will be Requested
  24.  
  25. The file is not case sensitive so any mix of upper and lower case is acceptable.
  26.  
  27. Request is desined to be run as a simple Door. It will check to see if the
  28. User is allowed to download any files (as determined by the 3 characters
  29. of the Sysop Comment string starting from specified offset). If the value
  30. here is greater than 0 then the files specified on the command line by the
  31. User will be scanned for in the DataBase INDEX file. Each file found matching
  32. the filespec(s) given by the User will be copied into a NEW INDEX file which
  33. MUST be included in you DLPATH.LST file. For each file copied, the number of
  34. files allowed will be decremented. This continues until the limit of files is
  35. reached or the filespecs run out. Wildcards are allowed in the filespec given
  36. by the User. The value will be updated in the Sysop Comment field of the Users
  37. record. The files will be flagged for download upon return to PCBoard.
  38.  
  39. The INDEX file should be overwritten in your $$LOGOFF.BAT by a dummy INDEX
  40. file to prevent another caller from downloading these same files.
  41.  
  42. To make the DataBase INDEX file, Type 'MAKEIDX pathlist[.PTH] indexname[.IDX]'
  43.  
  44. Where pathlist is an ASCII file (CR/LF delimited) listing paths that
  45. are to be scanned for files (including any subdirectories of the paths
  46. that are specified.
  47.  
  48. And the indexname is the name of the INDEX file to be created based
  49. on the files found in the paths specified by the pathlist file.
  50.  
  51. To make the Dummy INDEX file, create a pathlist file with an empty directory
  52. in it. This will create an INDEX file with no files in it. If this causes a
  53. problem for PCBOARD, create a directory and place a dummy file there so the
  54. INDEX will contain 1 file. You can then delete the file and directory. The
  55. filename should be some really odd filename so it doesn't get found in a file
  56. search normally.
  57.  
  58. You will need to regenerate then DataBase INDEX file anytime files are added
  59. or deleted to/from the directories. A simple batch file makes this easy though.
  60.  
  61. The Door should be set up as SHELL (but not SWAP!) but can be set up as Non-
  62. Shell. SWAP does not work as we need the PCBDOOR enviroment. A sample Door
  63. batch file would be:
  64.  
  65. REQUEST %PCBDRIVE%%PCBDIR% C:\PCB\REQUEST.CNF
  66.  
  67. '-----------------------------------------------------------------------------
  68.  
  69. This is just a Beta release of an idea to meet the need of a specific BBS.
  70. It does not offer the full features of a Door to fit many needs until I know
  71. just what the needs are.
  72.  
  73. Future developments could include a User database to eliminate the use of
  74. the Sysop comment field or maybe a TPA and use of the USERS.SYS file. This
  75. could allow setting limits for EACH download directory instead of a total
  76. file limit. Also a utility to set the limits into the DataBase or TPA based
  77. on Security Level or manual adjustment.
  78.  
  79. Please direct any questions or suggestions for enhancements to my BBS.
  80.  
  81. =========================================================================
  82.  
  83. CONTACTING THE AUTHOR
  84.  
  85. There are a number of ways to contact the author:
  86.  
  87.    1.  Call the support BBS,
  88.        SHARP Technical Support Line BBS
  89.        (404) 962-1788
  90.        9600/2400/1200/300 24 Hours.
  91.  
  92.    2.  Send net mail message through one of the mail networks in a CD-Rom
  93. Sysops, PCBoard, QuickBasic or TeleMate Conference addressed to 'Gary Meeker'.
  94. Available networks are Intelec, Rime, ILink and P/Net.
  95.  
  96.    3.  Send letter through regular post to the following address:
  97.  
  98.          ATTN: Gary Meeker
  99.          SHARP Technical Support Line BBS
  100.          725-C Old Norcross Road
  101.          Lawrenceville, GA 30245
  102.  
  103.    4.  Via Fax: (404) 995-0613
  104.  
  105. =========================================================================
  106.